.. highlightlang:: us

.. index:: @f{labeldataset}

.. _@f{labeldataset}:

@f{labeldataset}
================

.. us.tag  @f{labeldataset} GERMAN fieldfunction Changed5101

Die Feldfunktion beschriftet eine 2D-Kurve mit ihrem Legendentext oder dem
Y-Kanalnamen (siehe :ref:`XYSetLegendText`). 

Wenn der Datensatz gefilterte Daten enthält, hängt der Datenpunkt, der
beschriftet wird, von der Einstellung ab, ob die Marker für die Originaldaten
oder die gefilterten Daten ausgegeben werden. 

Wenn die Funktion ohne Parameter aufgerufen wird, wird der letzte Datenpunkt der
ersten Kurve im Diagramm beschriftet.

Bei einer Verschiebung der Beschriftung mit der Maus wird die Beschriftung an den
nächstliegenden Datenpunkt verschoben.

.. function::  @f{labeldataset}
    @f{labeldataset(DatasetIndex)}
    @f{labeldataset(DatasetIndex, Index)}
    @f{labeldataset(DatasetIndex, Index, xOffset)}
    @f{labeldataset(DatasetIndex, Index, xOffset, yOffset)}
    @f{labeldataset(DatasetIndex, Index, xOffset, yOffset, nAlign)}
    @f{labeldataset(DatasetIndex, Index, xOffset, yOffset, nAlign, ssText)}
    @f{labeldataset(Name)}
    @f{labeldataset(Name, Index)}
    @f{labeldataset(Name, Index, xOffset)}
    @f{labeldataset(Name, Index, xOffset, yOffset)}
    @f{labeldataset(Name, Index, xOffset, yOffset, nAlign)}
    @f{labeldataset(Name, Index, xOffset, yOffset, nAlign, ssText)}

.. us.params

**Parameter**

.. uparam:: DatasetIndex

   Index des Datensatzes. Der Index beginnt mit 1.

.. uparam:: Name

   Name des Datensatzes, der beschriftet werden soll, z. B. Data1.

.. uparam:: Index

   Index des Datenpunktes, der beschriftet werden soll.

   Beim Wert 1 wird die Beschriftung an den Datenpunkt mit der größten 
   x-Koordinate geschrieben.

   Beim Wert 0 wird die Beschriftung an den Datenpunkt mit der kleinsten 
   x-Koordinate geschrieben.

   Ein negativer Wert zählt vom Ende des Datensatzes (-2 beispielsweise
   beschriftet den vorletzten Datenpunkt). Ein positiver Wert zählt vom Anfang
   des Datensatzes. Defaultwert ist 1.

.. uparam:: xOffset

   Offset in cm in x-Richtung. Defaultwert ist 0.0.

.. uparam:: yOffset

   Offset in cm in y-Richtung. Defaultwert ist 0.0.

.. uparam:: nAlign

   Ankerpunkt des Textobjektes. Für den Wert -1 wird der Ankerpunkt automatisch
   bestimmt.

.. uparam:: ssText

   Wenn der Parameter den Wert **Y** enthält wird die Kurve dem dem y-Kanalnamen
   beschriftet. Ansonsten wird der Text angezeigt. Wenn der Parameter
   nicht angegeben ist wird der Legendentext verwendet.

.. us.example

**Beispiel**

``@f{labeldataset(Data1)}``

``@f{labeldataset(1, 1)}`` 

``@f{labeldataset(1, 1, 0.2)}`` 

Use y-channelname as label:

``@f{labeldataset(Data5, 1, 0.2, 0.0, -1, Y)}``  

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.10.1
     - Neue Parameter *nAlign* und *ssText* zugefügt.

.. seealso::
   :ref:`uberblick-feldfunktionen`,
   :ref:`bearbeitenfelder-aktualisieren`,
   :ref:`diagrammfeldfunktion-einfugen`,
   :ref:`dateialias-tabelle-bearbeiten`

:sub:`id-926120`